home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / fonts / pcx2font.zip / PCX2FONT.DOC < prev    next >
Text File  |  1988-08-16  |  6KB  |  195 lines
  1. PCX2FONT.ARC         Convert PCX Pictures to HP Fonts
  2.  
  3. Version 1.0                               James Bumgardner 08/15/88
  4.  
  5. All programs in this archive copyright James Bumgardner 1988.  
  6. For personal/non-profit use only.  Commercial Users may contact 
  7. the author at 818-846-7781 for licensing information. 
  8.  
  9. PC Paintbrush is a registered trademark of ZSoft Corporation.
  10.  
  11. *****************************************************************************
  12. *                                                                           *
  13. *        Latest Version can be found on Cooperworks BBS 608-271-3685        *
  14. *                                                                           *
  15. *****************************************************************************
  16.  
  17.  
  18. Revision History
  19. ----------------
  20. Version 1.0    JAB 08/15/88
  21.  
  22.     Fixed bug - PCX2FONT no longer crops bottom of letters.
  23.     Documented how to enter a double quote with -S option
  24.     Small or thin characters are supported better.
  25.     More complete handwriting sample included.
  26.     No longer including HANDWRIT.SFP, since this can be made from .PCX file.
  27.  
  28.  
  29. Version 0.5    JAB 08/01/88
  30.  
  31.  
  32. Contents of this archive
  33. ------------------------
  34.  
  35.     PCX2FONT.DOC        This File.
  36.     PCX2FONT.EXE        Bitmap to Font Converter.
  37.     FONT2PCX.EXE        Font to Bitmap Converter.
  38.     HANDWRIT.PCX        A Scan of my Handwriting.
  39.     HANDWRIT.CTL        Control File for HANDWRIT font.
  40.  
  41.  
  42. Program Description
  43. -------------------
  44.  
  45. PCX2FONT.EXE
  46.  
  47. This program converts a monochrome PC PAINTBRUSH file to an HP
  48. Laserjet+ portrait soft-font.  Possible uses are:
  49.  
  50.     * Quickly create a font by drawing it with a mouse.
  51.  
  52.     * Convert a scanned image of your handwriting to a font
  53.       (This is what the program was originally created for).
  54.  
  55.     * Convert scanned characters from a book to a font.
  56.  
  57.     * Convert PC Paintbrush fonts to HP fonts.
  58.  
  59.     * Using the included FONT2PCX program, edit an existing font
  60.       using PC Paintbrush.
  61.  
  62. The characters must be spaced far enough apart so a box can be
  63. drawn around each one without touching another character.  The
  64. file HANDWRIT.PCX is a scan of my handwriting (which is terrible),
  65. in a format acceptable to PCX2FONT.  A separate control file (with
  66. the extension .CTL) indicates which ascii characters the picture
  67. represents.  For example the file HANDWRIT.CTL looks like this:
  68.  
  69.  
  70. A B C D E F G
  71. H I J K L M N
  72. O P Q R S T U
  73. V W X Y Z
  74. a b c d e f g h i j k l m
  75. n o p q r s t u v w x y z
  76. 1 2 3 4 5 6 7 8 9 0
  77. ! " # $ % & ' ( ) * + , - . /
  78. : ; < = > ? @ [ \ ] ^ _ `
  79. { | } ~
  80.  
  81.  
  82. To use PCX2FONT, enter a command like the following:
  83.  
  84.     C> PCX2FONT HANDWRIT
  85.  
  86. This will create a new font HANDWRIT.SFP using the image HANDWRIT.PCX
  87. and the control file HANDWRIT.CTL.  You may also separately identify
  88. output and control files like so:
  89.  
  90.     C> PCX2FONT HANDWRIT.PCX OUTPUT.SFP TEST.CTL
  91.  
  92.  
  93. Syntax
  94. ------
  95.     PCX2FONT [options] pcx-file [sfp-file] [ctl-file]
  96.  
  97.  
  98. Options
  99. -------
  100.     -Q    Quiet Mode.
  101.  
  102.     -P##    This indicates the pitch in dots (300 dpi).  If
  103.         omitted, PCX2FONT will use the average font width.
  104.  
  105.     -H##    This indicates the height in dots (300 dpi).  If
  106.         omitted, PCX2FONT will use the maximum height above
  107.         the baseline.
  108.  
  109.     -X##    This indicates a value to add (or subtact) to each
  110.         character width to compute the X-Delta (amount printer
  111.         cursor moves after printing the letter).  Default is 2.
  112.  
  113.     -Sxxx    This option indicates which characters have clean
  114.         vertical breaks (splits) in them.  If a character is
  115.         split and PCX2FONT doesn't know it, it will treat the
  116.         image as two individual characters, and the assignment of
  117.         the remaining characters on that row will be out of sync. 
  118.         Follow the -S with the characters that are split.  For
  119.         example:
  120.  
  121.             C> PCX2FONT -Sabcde testfont
  122.  
  123.         
  124.         If the -S option is not used, the double quote (") is
  125.         considered split by default.  To include a double quote
  126.         in the -S option, precede it with a backslash:
  127.  
  128.             C> PCX2FONT -Sabc\"de testfont
  129.  
  130.         Otherwise, Turbo-C will not parse the command line correctly.
  131.         To turn the double quote default off, use -S alone.
  132.  
  133.  
  134. Tips and Caveats
  135. ----------------
  136.  
  137.     PCX2FONT identifies individual letters by the whitespace that
  138.     separates them.  Each row of letters must be separated by enough
  139.         whitespace to draw a horizontal line between them.  If this isn't
  140.     done correctly, you'll get the error message "Mismatched Rows".
  141.  
  142.     Within each row, each letter must be separated by enough whitespace
  143.     to draw a vertical line between them.  If any letters are too close
  144.     together, you'll get the error message "Can't find letter".
  145.  
  146.     You may specify a baseline by preceding each row of letters
  147.     in your picture by a small dot (4 X 4 pixels or less) at the
  148.     baseline position.  This is especially useful for fonts with a
  149.     lot of descenders.  Otherwise, PCX2FONT will guess at the baseline
  150.     positions for the regular descenders Q, g,j,p,q, and y.  Examine
  151.     the picture HANDWRIT.PCX for an example of this.
  152.  
  153.     Don't place a period or apostrophe at the beginning of a row, since
  154.     it might be confused with a baseline marker.
  155.  
  156.  
  157. FONT2PCX.EXE
  158.  
  159. This program converts a HP Laserjet+ Font to a monochrome PCX file for use
  160. with PC Paintbrush.  Through the combined use of this program and PCX2FONT,
  161. you can use PC Paintbrush as a font editor, taking advantage of it's
  162. drawing tools.  I do not recommend this procedure for well-constructed fonts,
  163. since you will lose the pitch and left-offset information, and the resulting 
  164. font will look somewhat cruder than the original when printed.  However, you
  165. can use these programs in conjunction with a good font editor to make unusual
  166. changes to an existing font.
  167.  
  168. You can also use this program to extract letters from a font for use
  169. with PC Paintbrush pictures. 
  170.  
  171.  
  172. Usage:
  173.     C> FONT2PCX [options/filters] sfp-file [pcx-file]
  174.  
  175.     Options:
  176.         -Q        Quiet Mode
  177.         -R        Reverse the colors (white on black)
  178.         -B        Add Baseline Markers
  179.     Filters:
  180.         -C        Capitals
  181.         -L        Lowercase
  182.         -A        Alpha Chars
  183.         -D        Digits
  184.         -P        Punctuation
  185.         -H        High Chars (ASCII value 128+)
  186. For example:
  187.  
  188.     C> FONT2PCX -C HANDWRIT.SFP CAPS.PCX
  189.  
  190. FONT2PCX will normally extract ALL characters, unless you use one or more
  191. of the filters.
  192.  
  193.  
  194. *** End of Documentation ***
  195.